home *** CD-ROM | disk | FTP | other *** search
/ NOVA - For the NeXT Workstation / NOVA - For the NeXT Workstation.iso / Apps / AudioApps / GISO / English.lproj / GISO.nib / data.nib (.txt) < prev    next >
NeXT TypedStream Data  |  1992-12-20  |  43KB  |  777 lines

  1. typedstream
  2. IBObjectData
  3. Object
  4. CustomObject
  5. Application
  6. Button
  7. Control
  8.     Responder
  9. [11@]
  10. ButtonCell
  11. ActionCell
  12.     Helvetica
  13. MenuTemplate
  14. *@*@ccc
  15. OtherViews
  16. Matrix
  17. MenuCell
  18. @:@iiii
  19. ff@@#::s
  20.     PopUpList
  21. popUp:
  22. NXImage
  23. NXpopup
  24.     TextField
  25. TextFieldCell
  26. Type:
  27. Rate:
  28. NXpulldown
  29. NXpulldownH
  30. Data Format:
  31. Data Size:
  32. Chanels:
  33. NXpopupH
  34. Output Sound
  35. Volume:
  36. Effect:
  37. Data Reverse Word Order?
  38. NXswitch
  39.     NXswitchH
  40. Arguements:
  41. Filters
  42. ScrollView
  43. ClipView
  44. ciifffcfffs
  45. [168c]{\rtf0\ansi{\fonttbl\f0\fswiss Helvetica;}
  46. \margl40
  47. \margr40
  48. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 
  49. NXCursor
  50. NXibeam
  51. Scroller
  52. _doScroller:
  53. @@@ffs3
  54. Do Conversion
  55. Helvetica-Bold
  56. Hot List
  57. playH
  58. stopH
  59. CustomView
  60. SoundMeter
  61. Result
  62. Save to Hot List...
  63. Input Sound
  64. Cancel
  65. NXreturnSign
  66. In Sound
  67. NXradio
  68. NXradioH
  69.     Out Sound
  70. Radio
  71. Entry Name:
  72. Which?
  73. WindowTemplate
  74. iiii***@s@
  75. Hot List Builder
  76. Panel
  77. [20@]
  78. Sound
  79. GISO2
  80. nwcColor
  81. GISO Version
  82. GISO by:
  83. 'Copyright 1992, Ronin Consulting, Inc. 
  84. Ronin
  85. Credits
  86. Lance Norskog
  87. sox by:
  88. Nicholas Christopher    
  89. nwc@gun.com
  90. thinman@netcom.com
  91. Guido Van Rossum
  92. Jef Poskanzer
  93. guido@cwi.nl
  94. jef@well.sf.ca.us
  95. @GISO comes with ABSOLUTELY NO WARRANTY, for details see Legal...
  96. sox contributers:
  97. [12943c]{\rtf0\ansi{\fonttbl\f0\fswiss Helvetica;}
  98. \margl40
  99. \margr40
  100. {\colortbl;\red0\green0\blue0;}
  101. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc1\cf1 \
  102.             GNU GENERAL PUBLIC LICENSE\
  103.              Version 1, February 1989\
  104.  Copyright (C) 1989 Free Software Foundation, Inc.\
  105.                     675 Mass Ave, Cambridge, MA 02139, USA\
  106.  Everyone is permitted to copy and distribute verbatim copies\
  107.  of this license document, but changing it is not allowed.\
  108.                 Preamble\
  109.   The license agreements of most software companies try to keep users\
  110. at the mercy of those companies.  By contrast, our General Public\
  111. License is intended to guarantee your freedom to share and change free\
  112. software--to make sure the software is free for all its users.  The\
  113. General Public License applies to the Free Software Foundation's\
  114. software and to any other program whose authors commit to using it.\
  115. You can use it for your programs, too.\
  116.   When we speak of free software, we are referring to freedom, not\
  117. price.  Specifically, the General Public License is designed to make\
  118. sure that you have the freedom to give away or sell copies of free\
  119. software, that you receive source code or can get it if you want it,\
  120. that you can change the software or use pieces of it in new free\
  121. programs; and that you know you can do these things.\
  122.   To protect your rights, we need to make restrictions that forbid\
  123. anyone to deny you these rights or to ask you to surrender the rights.\
  124. These restrictions translate to certain responsibilities for you if you\
  125. distribute copies of the software, or if you modify it.\
  126.   For example, if you distribute copies of a such a program, whether\
  127. gratis or for a fee, you must give the recipients all the rights that\
  128. you have.  You must make sure that they, too, receive or can get the\
  129. source code.  And you must tell them their rights.\
  130.   We protect your rights with two steps: (1) copyright the software, and\
  131. (2) offer you this license which gives you legal permission to copy,\
  132. distribute and/or modify the software.\
  133.   Also, for each author's protection and ours, we want to make certain\
  134. that everyone understands that there is no warranty for this free\
  135. software.  If the software is modified by someone else and passed on, we\
  136. want its recipients to know that what they have is not the original, so\
  137. that any problems introduced by others will not reflect on the original\
  138. authors' reputations.\
  139.   The precise terms and conditions for copying, distribution and\
  140. modification follow.\
  141.             GNU GENERAL PUBLIC LICENSE\
  142.    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION\
  143.   0. This License Agreement applies to any program or other work which\
  144. contains a notice placed by the copyright holder saying it may be\
  145. distributed under the terms of this General Public License.  The\
  146. "Program", below, refers to any such program or work, and a "work based\
  147. on the Program" means either the Program or any work containing the\
  148. Program or a portion of it, either verbatim or with modifications.  Each\
  149. licensee is addressed as "you".\
  150.   1. You may copy and distribute verbatim copies of the Program's source\
  151. code as you receive it, in any medium, provided that you conspicuously and\
  152. appropriately publish on each copy an appropriate copyright notice and\
  153. disclaimer of warranty; keep intact all the notices that refer to this\
  154. General Public License and to the absence of any warranty; and give any\
  155. other recipients of the Program a copy of this General Public License\
  156. along with the Program.  You may charge a fee for the physical act of\
  157. transferring a copy.\
  158.   2. You may modify your copy or copies of the Program or any portion of\
  159. it, and copy and distribute such modifications under the terms of Paragraph\
  160. 1 above, provided that you also do the following:\
  161.     a) cause the modified files to carry prominent notices stating that\
  162.     you changed the files and the date of any change; and\
  163.     b) cause the whole of any work that you distribute or publish, that\
  164.     in whole or in part contains the Program or any part thereof, either\
  165.     with or without modifications, to be licensed at no charge to all\
  166.     third parties under the terms of this General Public License (except\
  167.     that you may choose to grant warranty protection to some or all\
  168.     third parties, at your option).\
  169.     c) If the modified program normally reads commands interactively when\
  170.     run, you must cause it, when started running for such interactive use\
  171.     in the simplest and most usual way, to print or display an\
  172.     announcement including an appropriate copyright notice and a notice\
  173.     that there is no warranty (or else, saying that you provide a\
  174.     warranty) and that users may redistribute the program under these\
  175.     conditions, and telling the user how to view a copy of this General\
  176.     Public License.\
  177.     d) You may charge a fee for the physical act of transferring a\
  178.     copy, and you may at your option offer warranty protection in\
  179.     exchange for a fee.\
  180. Mere aggregation of another independent work with the Program (or its\
  181. derivative) on a volume of a storage or distribution medium does not bring\
  182. the other work under the scope of these terms.\
  183.   3. You may copy and distribute the Program (or a portion or derivative of\
  184. it, under Paragraph 2) in object code or executable form under the terms of\
  185. Paragraphs 1 and 2 above provided that you also do one of the following:\
  186.     a) accompany it with the complete corresponding machine-readable\
  187.     source code, which must be distributed under the terms of\
  188.     Paragraphs 1 and 2 above; or,\
  189.     b) accompany it with a written offer, valid for at least three\
  190.     years, to give any third party free (except for a nominal charge\
  191.     for the cost of distribution) a complete machine-readable copy of the\
  192.     corresponding source code, to be distributed under the terms of\
  193.     Paragraphs 1 and 2 above; or,\
  194.     c) accompany it with the information you received as to where the\
  195.     corresponding source code may be obtained.  (This alternative is\
  196.     allowed only for noncommercial distribution and only if you\
  197.     received the program in object code or executable form alone.)\
  198. Source code for a work means the preferred form of the work for making\
  199. modifications to it.  For an executable file, complete source code means\
  200. all the source code for all modules it contains; but, as a special\
  201. exception, it need not include source code for modules which are standard\
  202. libraries that accompany the operating system on which the executable\
  203. file runs, or for standard header files or definitions files that\
  204. accompany that operating system.\
  205.   4. You may not copy, modify, sublicense, distribute or transfer the\
  206. Program except as expressly provided under this General Public License.\
  207. Any attempt otherwise to copy, modify, sublicense, distribute or transfer\
  208. the Program is void, and will automatically terminate your rights to use\
  209. the Program under this License.  However, parties who have received\
  210. copies, or rights to use copies, from you under this General Public\
  211. License will not have their licenses terminated so long as such parties\
  212. remain in full compliance.\
  213.   5. By copying, distributing or modifying the Program (or any work based\
  214. on the Program) you indicate your acceptance of this license to do so,\
  215. and all its terms and conditions.\
  216.   6. Each time you redistribute the Program (or any work based on the\
  217. Program), the recipient automatically receives a license from the original\
  218. licensor to copy, distribute or modify the Program subject to these\
  219. terms and conditions.  You may not impose any further restrictions on the\
  220. recipients' exercise of the rights granted herein.\
  221.   7. The Free Software Foundation may publish revised and/or new versions\
  222. of the General Public License from time to time.  Such new versions will\
  223. be similar in spirit to the present version, but may differ in detail to\
  224. address new problems or concerns.\
  225. Each version is given a distinguishing version number.  If the Program\
  226. specifies a version number of the license which applies to it and "any\
  227. later version", you have the option of following the terms and conditions\
  228. either of that version or of any later version published by the Free\
  229. Software Foundation.  If the Program does not specify a version number of\
  230. the license, you may choose any version ever published by the Free Software\
  231. Foundation.\
  232.   8. If you wish to incorporate parts of the Program into other free\
  233. programs whose distribution conditions are different, write to the author\
  234. to ask for permission.  For software which is copyrighted by the Free\
  235. Software Foundation, write to the Free Software Foundation; we sometimes\
  236. make exceptions for this.  Our decision will be guided by the two goals\
  237. of preserving the free status of all derivatives of our free software and\
  238. of promoting the sharing and reuse of software generally.\
  239.                 NO WARRANTY\
  240.   9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY\
  241. FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN\
  242. OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES\
  243. PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED\
  244. OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\
  245. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS\
  246. TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE\
  247. PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,\
  248. REPAIR OR CORRECTION.\
  249.   10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING\
  250. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR\
  251. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,\
  252. INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING\
  253. OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED\
  254. TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY\
  255. YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER\
  256. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE\
  257. POSSIBILITY OF SUCH DAMAGES.\
  258.              END OF TERMS AND CONDITIONS\
  259.     Appendix: How to Apply These Terms to Your New Programs\
  260.   If you develop a new program, and you want it to be of the greatest\
  261. possible use to humanity, the best way to achieve this is to make it\
  262. free software which everyone can redistribute and change under these\
  263. terms.\
  264.   To do so, attach the following notices to the program.  It is safest to\
  265. attach them to the start of each source file to most effectively convey\
  266. the exclusion of warranty; and each file should have at least the\
  267. "copyright" line and a pointer to where the full notice is found.\
  268.     <one line to give the program's name and a brief idea of what it does.>\
  269.     Copyright (C) 19yy  <name of author>\
  270.     This program is free software; you can redistribute it and/or modify\
  271.     it under the terms of the GNU General Public License as published by\
  272.     the Free Software Foundation; either version 1, or (at your option)\
  273.     any later version.\
  274.     This program is distributed in the hope that it will be useful,\
  275.     but WITHOUT ANY WARRANTY; without even the implied warranty of\
  276.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\
  277.     GNU General Public License for more details.\
  278.     You should have received a copy of the GNU General Public License\
  279.     along with this program; if not, write to the Free Software\
  280.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.\
  281. Also add information on how to contact you by electronic and paper mail.\
  282. If the program is interactive, make it output a short notice like this\
  283. when it starts in an interactive mode:\
  284.     Gnomovision version 69, Copyright (C) 19xx name of author\
  285.     Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.\
  286.     This is free software, and you are welcome to redistribute it\
  287.     under certain conditions; type `show c' for details.\
  288. The hypothetical commands `show w' and `show c' should show the\
  289. appropriate parts of the General Public License.  Of course, the\
  290. commands you use may be called something other than `show w' and `show\
  291. c'; they could even be mouse-clicks or menu items--whatever suits your\
  292. program.\
  293. You should also get your employer (if you work as a programmer) or your\
  294. school, if any, to sign a "copyright disclaimer" for the program, if\
  295. necessary.  Here a sample; alter the names:\
  296.   Yoyodyne, Inc., hereby disclaims all copyright interest in the\
  297.   program `Gnomovision' (a program to direct compilers to make passes\
  298.   at assemblers) written by James Hacker.\
  299.   <signature of Ty Coon>, 1 April 1989\
  300.   Ty Coon, President of Vice\
  301. That's all there is to it!\
  302. Save As...
  303. Open...
  304. Help...
  305. Info Panel...
  306. Legal...
  307. Preferences...
  308. [1322c]{\rtf0\ansi{\fonttbl\f0\fswiss Helvetica;}
  309. \margl40
  310. \margr40
  311. \pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\f0\b\i0\ulnone\fs28\fc0\cf0 GISO\
  312. \b0 Giso is just a wrapper for Lance Norskog's sox program.  The sox program lets you convert many sound types back and forth amongst each other as well as create some effects. GISO does make sox far more useable though.\
  313. \b Basic Use
  314. \b0 \
  315. Just open a sound using the 
  316. \i Sound>Open..
  317. \i0   menu item. Describe the sounds properties in the 
  318. \i input sound
  319. \i0  area. In the 
  320. \i output sound
  321. \i0  area describe what you what the sound to become. Hit 
  322. \i Do Convert
  323. \i0 . The dialog area lets you see what sox has to say about what you just did. It is possible to describe from GISO things that sox won't do, but sox will complain and indicate what corse of action to take.\
  324. \b Sound Play\
  325. \b0 The Play and Stop buttons let you review the sound you have created if it is a sound type the NeXT can play.\
  326. \b Hot Lists\
  327. \b0 If you have a very common input or output setting, just configure GISO and hit 
  328. \i Save to Hot List...
  329. \i0   The popup asks if this is an input or output setting and for a name. If you hit OK then the hotlist will be save to a file in the directory you defined in the preferences and the hot list will be updateed.
  330. About Sox...
  331. submenuAction:
  332. NXmenuArrow
  333. Paste
  334. Select All
  335. GISOPrefPanel
  336. [14536c]{\rtf0\ansi{\fonttbl\f0\fswiss Helvetica;}
  337. \margl40
  338. \margr40
  339. {\colortbl;\red0\green0\blue0;}
  340. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc1\cf1 \
  341. SOX(1)              UNIX Programmer's Manual               SOX(1)\
  342. NAME\
  343.      sox - SOund eXchange - universal sound sample translator\
  344. SYNOPSIS\
  345.      sox 
  346. \b infile outfile
  347. \b0 \
  348.      sox 
  349. \b infile outfile
  350. \b0  [ 
  351. \b effect
  352. \b0  [ 
  353. \b effect
  354. \b0  
  355. \b options
  356. \b0  ... ] ]\
  357.      sox 
  358. \b infile
  359. \b0  -e 
  360. \b effect
  361. \b0  [ 
  362. \b effect
  363. \b0  
  364. \b options
  365. \b0  ... ]\
  366.      sox [ 
  367. \b general
  368. \b0  
  369. \b options
  370. \b0   ] [ 
  371. \b format
  372. \b0  
  373. \b options
  374. \b0   ] 
  375. \b ifile
  376. \b0  [ 
  377. \b format
  378. \b0 \
  379.      
  380. \b options
  381. \b0   ] 
  382. \b ofile
  383. \b0  [ 
  384. \b effect
  385. \b0  [ 
  386. \b effect
  387. \b0  
  388. \b options
  389. \b0  ... ] ]\
  390.      
  391. \b General
  392. \b0  
  393. \b options
  394. \b0 : [ -V ] [ -v 
  395. \b volume
  396. \b0  ]\
  397.      
  398. \b Format
  399. \b0  
  400. \b options
  401. \b0 : [ -t 
  402. \b filetype
  403. \b0  ] [ -r 
  404. \b rate
  405. \b0  ] [ -s/-u/-U/-A ]\
  406.      [ -b/-w/-l/-f/-d/-D ] [ -c 
  407. \b channels
  408. \b0  ] [ -x ]\
  409.      
  410. \b Effects
  411. \b0 :\
  412.           copy\
  413.           rate\
  414.           avg\
  415.           stat\
  416.           echo 
  417. \b delay volume
  418. \b0  [ 
  419. \b delay volume
  420. \b0  ... ]\
  421.           vibro 
  422. \b speed
  423. \b0  [ 
  424. \b depth
  425. \b0  ]\
  426.           lowp 
  427. \b center
  428. \b0 \
  429.           band [ -n ] 
  430. \b center
  431. \b0  [ 
  432. \b width
  433. \b0  ]\
  434. DESCRIPTION\
  435.      
  436. \b Sox
  437. \b0  translates sound files from one format to another, pos-\
  438.      sibly doing a sound effect.\
  439. OPTIONS\
  440.      The option syntax is a little grotty, but in essence:\
  441.           sox file.au file.voc\
  442.      translates a sound sample in SUN Sparc .AU format into a\
  443.      SoundBlaster .VOC file, while\
  444.           sox -v 0.5 file.au -rate 12000 file.voc rate\
  445.      does the same format translation but also lowers the ampli-\
  446.      tude by 1/2 and changes the sampling rate from 8000 hertz to\
  447.      12000 hertz via the rate 
  448. \b sound
  449. \b0  
  450. \b effect
  451. \b0  loop.\
  452.      File type options:\
  453.      -t 
  454. \b filetype
  455. \b0 \
  456.                gives the type of the sound sample file.\
  457.      -r 
  458. \b rate
  459. \b0    Give sample rate in Hertz of file.\
  460.      -s/-u/-U/-A\
  461.                The sample data is signed linear (2's complement),\
  462.                unsigned linear, U-law (logarithmic), or A-law\
  463.                (logarithmic).  U-law and A-law are the U.S. and\
  464.                international standards for logarithmic telephone\
  465.                sound compression.\
  466.      -b/-w/-l/-f/-d/-D\
  467.                The sample data is in bytes, 16-bit words, 32-bit\
  468.                longwords, 32-bit floats, 64-bit double floats, or\
  469.                80-bit IEEE floats.  Floats and double floats are\
  470.                in native machine format.\
  471.      -x        The sample data is in XINU format; that is, it\
  472.                comes from a machine with the opposite word order\
  473.                than yours and must be swapped according to the\
  474.                word-size given above.  Only 16-bit and 32-bit\
  475.                integer data may be swapped.  Machine-format\
  476.                floating-point data is not portable.  IEEE floats\
  477.                are a fixed, portable format. ???\
  478.      -c 
  479. \b channels
  480. \b0 \
  481.                The number of sound channels in the data file.\
  482.                This may be 1, 2, or 4; for mono, stereo, or quad\
  483.                sound data.\
  484.      General options:\
  485.      -e        after the input file allows you to avoid giving an\
  486.                output file and just name an effect.  This is only\
  487.                useful with the stat effect.\
  488.      -v 
  489. \b volume
  490. \b0  Change amplitude (floating point); less than 1.0\
  491.                decreases, greater than 1.0 increases.  Note: we\
  492.                perceive volume logarithmically, not linearly.\
  493.                Note: see the stat effect.\
  494.      -V        Print a description of processing phases.  Useful\
  495.                for figuring out exactly how sox is mangling your\
  496.                sound samples.\
  497.      The input and output files may be standard input and output.\
  498.     This is specified by '-'.  The -t 
  499. \b type
  500. \b0  option must be given\
  501.      in this case, else sox will not know the format of the given\
  502.      file.  The -t, -r, -s/-u/-U/-A, -b/-w/-l/-f/-d/-D and -x\
  503.      options refer to the input data when given before the input\
  504.      file name.  After, they refer to the output data.\
  505.      If you don't give an output file name, 
  506. \b sox
  507. \b0  will just read\
  508.      the input file.  This is useful for validating structured\
  509.      file formats; the stat effect may also be used via the -e\
  510.      option.\
  511. FILE TYPES\
  512.      
  513. \b Sox
  514. \b0  needs to know the formats of the input and output files.\
  515.      File formats which have headers are checked, if that header\
  516.      doesn't seem right, the program exits with an appropriate\
  517.      message.  Currently, the raw (no header), IRCAM Sound Files,\
  518.      Sound Blaster, SPARC .AU (w/header), Mac HCOM, PC/DOS .SOU,\
  519.      Sndtool, and Sounder, NeXT .SND, Windows 3.1 RIFF/WAV, and\
  520.      Amiga/SGI AIFF and 8SVX formats are supported.\
  521.      .aiff     AIFF files used on Amiga and SGI.  Note: the AIFF\
  522.                format supports only one SSND chunk.  It does not\
  523.                support multiple sound chunks, or the 8SVX musical\
  524.                instrument description format.  AIFF files are\
  525.                multimedia archives and and can have multiple\
  526.                audio and picture chunks.  You may need a separate\
  527.                archiver to work with them.\
  528.      .au       SUN Microsystems AU files.  There are apparently\
  529.                many types of .au files; DEC has invented its own\
  530.                with a different magic number and word order. The\
  531.                .au handler can read these files but will not\
  532.                write them.  Some .au files have valid AU headers\
  533.                and some do not.  The latter are probably original\
  534.                SUN u-law 8000 hz samples.  These can be dealt\
  535.                with using the .ul format (see below).\
  536.      .hcom     Macintosh HCOM files.  These are (apparently) Mac\
  537.                FSSD files with some variant of Huffman compres-\
  538.                sion.  The Macintosh has wacky file formats and\
  539.                this format handler apparently doesn't handle all\
  540.                the ones it should.  Mac users will need your\
  541.                usual arsenal of file converters to deal with an\
  542.                HCOM file under Unix or DOS.\
  543.      .raw      Raw files (no header).\
  544.               The sample rate, size (byte, word, etc), and style\
  545.                (signed, unsigned, etc.) of the sample file must\
  546.                be given.  The number of channels defaults to 1.\
  547.      .ub, .sb, .uw, .sw, .ul\
  548.                These are several suffices which serve as a short-\
  549.                hand for raw files with a given size and style.\
  550.                Thus, ub, sb, uw, sw, and ul correspond to\
  551.                "unsigned byte", "signed byte", "unsigned word",\
  552.                "signed word", and "ulaw" (byte).  The sample rate\
  553.                defaults to 8000 hz if not explicitly set, and the\
  554.                number of channels (as always) defaults to 1.\
  555.                There are lots of Sparc samples floating around in\
  556.                u-law format with no header and fixed at a sample\
  557.                rate of 8000 hz.  (Certain sound management\
  558.                software cheerfully ignores the headers.) Simi-\
  559.                larly, most Mac sound files are in unsigned byte\
  560.                format with a sample rate of 11025 or 22050 hz.\
  561.      .sf       IRCAM Sound Files.\
  562.                SoundFiles are used by academic music software\
  563.                such as the CSound package, and the MixView sound\
  564.                sample editor.\
  565.      .voc      Sound Blaster VOC files.\
  566.                VOC files are multi-part and contain silence\
  567.                parts, looping, and different sample rates for\
  568.                different chunks.  On input, the silence parts are\
  569.                filled out, loops are rejected, and sample data\
  570.                with a new sample rate is rejected.  Silence with\
  571.                a different sample rate is generated appropri-\
  572.                ately.  On output, silence is not detected, nor\
  573.                are impossible sample rates.\
  574.      .wav      Windows 3.1 .WAV RIFF files.\
  575.                These appear to be very similar to IFF files, but\
  576.                not the same. They are the native sound file for-\
  577.                mat of Windows 3.1.  Obviously, Windows 3.1 is of\
  578.                such incredible importance to the computer indus-\
  579.                try that it just had to have its own sound file\
  580.                format.\
  581. EFFECTS\
  582.      Only one effect from the palette may be applied to a sound\
  583.      sample.  To do multiple effects you'll need to run sox in a\
  584.      pipeline.\
  585.      copy                          Copy the input file to the\
  586.                                    output file.  This is the\
  587.                                    default effect if both files\
  588.                                    have the same sampling rate,\
  589.                                    or the rates are "close".\
  590.      rate                          Translate input sampling rate\
  591.                                    to output sampling rate via\
  592.                                    linear interpolation to the\
  593.                                    Least Common Multiple of the\
  594.                                    two sampling rates.  This is\
  595.                                    the default effect if the two\
  596.                                    files have different sampling\
  597.                                    rates.  This is fast but\
  598.                                    noisy.\
  599.      avg                           Mix 4- or 2-channel sound file\
  600.                                    into 2- or 1-channel file by\
  601.                                    averaging the samples for dif-\
  602.                                    ferent speakers.\
  603.      stat                          Do a statistical check on the\
  604.                                   input file, and print results\
  605.                                    on the standard error file.\
  606.                                    stat may copy the file\
  607.                                    untouched from input to out-\
  608.                                    put, if you select an output\
  609.                                    file. The "Volume Adjustment:"\
  610.                                    field in the statistics gives\
  611.                                    you the argument to the -v\
  612.                                    
  613. \b number
  614. \b0  which will make the\
  615.                                    sample as loud as possible.\
  616.      echo [
  617. \b  delay volume
  618. \b0  ...  ]    Add echoing to a sound sample.\
  619.                                    Each delay/volume pair gives\
  620.                                    the delay in seconds and the\
  621.                                    volume (relative to 1.0) of\
  622.                                    that echo.  If the volumes add\
  623.                                    up to more than 1.0, the sound\
  624.                                    will melt down instead of fad-\
  625.                                    ing away.\
  626.      vibro 
  627. \b speed
  628. \b0   [ 
  629. \b depth
  630. \b0  ]        Add the world-famous Fender\
  631.                                    Vibro-Champ sound effect to a\
  632.                                    sound sample by using a sine\
  633.                                    wave as the volume knob.\
  634.                                    Speed gives the Hertz value of\
  635.                                    the wave.  This must be under\
  636.                                    30.  Depth gives the amount\
  637.                                    the volume is cut into by the\
  638.                                    sine wave, ranging 0.0 to 1.0\
  639.                                    and defaulting to 0.5.\
  640.      lowp center                   Apply a low-pass filter.  The\
  641.                                    frequency response drops loga-\
  642.                                    rithmically with center fre-\
  643.                                    quency in the middle of the\
  644.                                    drop.  The slope of the filter\
  645.                                    is quite gentle.\
  646.      band [ -n ] 
  647. \b center
  648. \b0  [ 
  649. \b width
  650. \b0  ]  Apply a band-pass filter.  The\
  651.                                    frequency response drops loga-\
  652.                                    rithmically around the center\
  653.                                    frequency.  The width gives\
  654.                                    the slope of the drop.  The\
  655.                                    frequencies at center + width\
  656.                                    and center - width will be\
  657.                                    half of their original ampli-\
  658.                                    tudes.  Band defaults to a\
  659.                                    mode oriented to pitched sig-\
  660.                                    nals, i.e. voice, singing, or\
  661.                                    instrumental music.  The -n\
  662.                                    (for noise) option uses the\
  663.                                    alternate mode for un-pitched\
  664.                                    signals.  Band introduces\
  665.                                    noise in the shape of the\
  666.                                    filter, i.e. peaking at the\
  667.                                    
  668. \b center
  669. \b0  frequency and settling\
  670.                                    around it.\
  671.      Sox enforces certain effects.  If the two files have dif-\
  672.      ferent sampling rates, the requested effect must be one of\
  673.      copy, or rate, If the two files have different numbers of\
  674.      channels, the avg effect must be requested.\
  675. BUGS\
  676.      The syntax is horrific.  It's very tempting to include a\
  677.      default system that allows an effect name as the program\
  678.      name and just pipes a sound sample from standard input to\
  679.      standard output, but the problem of inputting the sample\
  680.      rates makes this unworkable.\
  681. FILES\
  682. SEE ALSO\
  683. NOTICES\
  684.      The echoplex effect is:\
  685.          Copyright (C) 1989 by Jef Poskanzer.\
  686.          Permission to use, copy, modify, and distribute this\
  687.      software and its\
  688.          documentation for any purpose and without fee is hereby\
  689.      granted, provided\
  690.          that the above copyright notice appear in all copies and\
  691.      that both that\
  692.          copyright notice and this permission notice appear in\
  693.      supporting\
  694.          documentation.  This software is provided "as is"\
  695.      without express or\
  696.          implied warranty.\
  697. Controller
  698. Window
  699. COPYING
  700. Button17
  701. Field97
  702. Button47
  703. Field37
  704. ScrollingText7
  705. Field17
  706. Field47
  707. Field27D
  708. Button27
  709. Field127:
  710. Field7
  711. Field87
  712. Field57G
  713. GISOPrefPanelInstance7J
  714. Play7
  715. Sox7=
  716. File's Owner7
  717. Stop7
  718. Button37
  719. Field147
  720. Field117
  721. Copying7
  722. Field157
  723.     MainPanel7
  724. VersionNumber7
  725. Field67
  726. Field137
  727. Field107
  728. HotList7
  729. Field77
  730. MainMenu7
  731. [49@]
  732. IBControlConnector
  733. IBConnector
  734. hide:
  735. IBOutletConnector
  736. inType
  737. inRate
  738. inDataForm
  739. inDataSize
  740. inChannels
  741. outType
  742. outRate
  743. outDataForm
  744. outDataSize
  745. outChannels
  746. dialog
  747. effect
  748. volume
  749.     swapBytes
  750. convert:
  751.     openFile:
  752.     saveFile:
  753. delegate
  754. inRateText
  755. outRateText
  756. copyValue:
  757. panel
  758. copy:
  759. paste:
  760. selectAll:
  761. playIt:
  762.     stopPlay:
  763. playButton
  764.     inHotList
  765. outHotList
  766. soundMeter
  767. makeKeyAndOrderFront:
  768. saveToHotList:
  769. performClose:
  770.     entryName
  771. whichRadio
  772. effectArgText
  773. cleanKill:
  774. performClick:
  775. convert
  776.     versionNo
  777.